<!DOCTYPE html>
<html lang="en">
<head>
	<meta charset="UTF-8">
	<meta http-equiv="X-UA-Compatible" content="IE=edge">
    <meta name="viewport" content="width=device-width, initial-scale=1">
	<title>常用(common)词项查询 | ElasticSearch 7.7 权威指南中文版</title>
	<meta name="keywords" content="ElasticSearch 权威指南中文版, elasticsearch 7, es7, 实时数据分析，实时数据检索" />
    <meta name="description" content="ElasticSearch 权威指南中文版, elasticsearch 7, es7, 实时数据分析，实时数据检索" />
    <!-- Give IE8 a fighting chance -->
    <!--[if lt IE 9]>
    <script src="https://oss.maxcdn.com/html5shiv/3.7.2/html5shiv.min.js"></script>
    <script src="https://oss.maxcdn.com/respond/1.4.2/respond.min.js"></script>
    <![endif]-->
	<link rel="stylesheet" type="text/css" href="../static/styles.css" />
	<script>
	var _link = 'query-dsl-common-terms-query.html';
    </script>
</head>
<body>
<div class="main-container">
    <section id="content">
        <div class="content-wrapper">
            <section id="guide" lang="zh_cn">
                <div class="container">
                    <div class="row">
                        <div class="col-xs-12 col-sm-8 col-md-8 guide-section">
                            <div style="color:gray; word-break: break-all; font-size:12px;">原英文版地址: <a href="https://www.elastic.co/guide/en/elasticsearch/reference/7.7/query-dsl-common-terms-query.html" rel="nofollow" target="_blank">https://www.elastic.co/guide/en/elasticsearch/reference/7.7/query-dsl-common-terms-query.html</a>, 原文档版权归 www.elastic.co 所有<br/>本地英文版地址: <a href="../en/query-dsl-common-terms-query.html" rel="nofollow" target="_blank">../en/query-dsl-common-terms-query.html</a></div>
                        <!-- start body -->
                  <div class="page_header">
<strong>重要</strong>: 此版本不会发布额外的bug修复或文档更新。最新信息请参考 <a href="https://www.elastic.co/guide/en/elasticsearch/reference/current/index.html" rel="nofollow">当前版本文档</a>。
</div>
<div id="content">
<div class="breadcrumbs">
<span class="breadcrumb-link"><a href="index.html">Elasticsearch 权威指南 [7.7]</a></span>
»
<span class="breadcrumb-link"><a href="query-dsl.html">查询领域特定语言(Query DSL)</a></span>
»
<span class="breadcrumb-link"><a href="full-text-queries.html">全文查询</a></span>
»
<span class="breadcrumb-node">常用(common)词项查询</span>
</div>
<div class="navheader">
<span class="prev">
<a href="query-dsl-multi-match-query.html">« 多字段匹配(multi_match)查询</a>
</span>
<span class="next">
<a href="query-dsl-query-string-query.html">查询字符串(query_string)查询 »</a>
</span>
</div>
<div class="section">
<div class="titlepage"><div><div>
<h2 class="title">
<a id="query-dsl-common-terms-query"></a>常用(common)词项查询
</h2>
</div></div></div>
<div class="warning admon">
<div class="icon"></div>
<div class="admon_content">
<h3>在7.3.0中废弃。</h3>
<p> 请改用<a class="xref" href="query-dsl-match-query.html" title="match query">match查询</a>，它可以有效地跳过文档块，而无需任何配置，前提是不跟踪命中的总数。</p>
</div>
</div>
<p>
<code class="literal">common</code> 词项查询是停止词的现代替代方法，它提高了搜索结果的精确度和召回率(通过将停止词考虑在内)，而不牺牲性能。
</p>
<h4>
<a id="_the_problem"></a>问题
</h4>
<p>
查询中的每一个词项都有成本。

搜索 <code class="literal">"The brown fox"</code> 需要三个词项查询，分别针对<code class="literal">"the"</code>、<code class="literal">"brown"</code> 和 <code class="literal">"fox"</code>，所有这些词项都要对索引中的所有文档执行匹配。

对 <code class="literal">"the"</code> 的查询可能匹配许多文档，因此对相关性的影响比其他两个词项小得多。
</p>
<p>
以前解决这个问题的方法是忽略高频词。

通过将<code class="literal">"the"</code>视为<em>stopword</em>(停止词)，减小了索引的大小，并减少了需要执行的词项查询的数量。
</p>
<p>
这种方法的问题是，虽然停止词对相关性的影响很小，但它们仍然很重要。

如果我们删除了停止词，我们就失去了精确性（例如，我们无法区分<code class="literal">"happy"</code> 与 <code class="literal">"not happy"</code>），我们也失去了回调（例如，像 <code class="literal">"The The"</code> 或 <code class="literal">"To be or not to be"</code> 这样的文本根本不会存在于索引中）。
</p>
<h4>
<a id="_the_solution"></a>解决方案
</h4>
<p>
<code class="literal">common</code> 词项查询将要查询的词项分为两组：更重要的（即低频词项）和不太重要的（即以前是停止词的高频词项）。
</p>
<p>
首先，它搜索与更重要的词项匹配的文档（第一次查询）。

这些词项出现在更少的文档中，而对相关性有更大的影响。
</p>
<p>
然后，对不太重要的词项执行第二次查询，这些词项经常出现，对相关性的影响很小。

但是，它不会计算<span class="strong strong"><strong>所有</strong></span>匹配的文档的相关性评分，而是只计算第一个查询中已经匹配的文档的 <code class="literal">_score</code>。

通过这种方式，高频词项可以在不付出性能低下的代价的情况下改进相关性计算。  
</p>
<p>
如果一个查询只包含高频词，那么单个查询将作为 <code class="literal">AND</code>（与）查询执行，换句话说，所有词项都是必需的。

尽管每个单独的词项会匹配许多文档，但是词项的组合将结果集缩小到仅最相关的文档。

单个查询也可以通过指定参数 <a class="xref" href="query-dsl-minimum-should-match.html" title="minimum_should_match parameter"><code class="literal">minimum_should_match</code></a> 作为 <code class="literal">OR</code> 来执行，在这种情况下，应该（给该参数）使用足够高的值。
</p>
<p>
根据 <code class="literal">cutoff_frequency</code> 将词项分配给高频组或低频组，可将其指定为绝对频率(<code class="literal">&gt;=1</code>)或相对频率(<code class="literal">0.0 ~ 1.0</code>)。

(请记住，文档频率是在每个分片级别上计算的，正如在博客 <a href="https://www.elastic.co/guide/en/elasticsearch/guide/2.x/relevance-is-broken.html" class="ulink" target="_top">相关性被打破了</a> 中所解释的那样。)
</p>
<p>
也许这个查询最有趣的特性是它能自动适应特定领域的停止词。

例如，在一个视频托管网站上，像 <code class="literal">"clip"</code> 或 <code class="literal">"video"</code> 这样的常用词项会自动作为停止词，而不需要手动维护一个列表。
</p>
<h4>
<a id="_examples_2"></a>示例
</h4>
<p>
在本例中，文档频率大于0.1%的单词（例如<code class="literal">"this"</code> 和 <code class="literal">"is"</code>）将被视为常用词。
</p>
<div class="pre_wrapper lang-console">
<pre class="programlisting prettyprint lang-console">GET /_search
{
    "query": {
        "common": {
            "body": {
                "query": "this is bonsai cool",
                "cutoff_frequency": 0.001
            }
        }
    }
}</pre>
</div>
<div class="console_widget" data-snippet="snippets/142.console"></div>
<p>
应该匹配的词项的数量可以用参数 <a class="xref" href="query-dsl-minimum-should-match.html" title="minimum_should_match parameter"><code class="literal">minimum_should_match</code></a> (<code class="literal">high_freq</code>, <code class="literal">low_freq</code>)，<code class="literal">low_freq_operator</code> (默认为 <code class="literal">"or"</code>) 和 <code class="literal">high_freq_operator</code> (默认为 <code class="literal">"or"</code>) 来控制。
</p>
<p>
对于低频词项，将  <code class="literal">low_freq_operator</code> 设置为<code class="literal">"and"</code>，以使所有术语都是必需的：
</p>
<div class="pre_wrapper lang-console">
<pre class="programlisting prettyprint lang-console">GET /_search
{
    "query": {
        "common": {
            "body": {
                "query": "nelly the elephant as a cartoon",
                "cutoff_frequency": 0.001,
                "low_freq_operator": "and"
            }
        }
    }
}</pre>
</div>
<div class="console_widget" data-snippet="snippets/143.console"></div>
<p>这大致相当于：</p>
<div class="pre_wrapper lang-console">
<pre class="programlisting prettyprint lang-console">GET /_search
{
    "query": {
        "bool": {
            "must": [
            { "term": { "body": "nelly"}},
            { "term": { "body": "elephant"}},
            { "term": { "body": "cartoon"}}
            ],
            "should": [
            { "term": { "body": "the"}},
            { "term": { "body": "as"}},
            { "term": { "body": "a"}}
            ]
        }
    }
}</pre>
</div>
<div class="console_widget" data-snippet="snippets/144.console"></div>
<p>
或者，使用 <a class="xref" href="query-dsl-minimum-should-match.html" title="minimum_should_match parameter"><code class="literal">minimum_should_match</code></a> 指定必须出现的低频词项的最小数量或百分比，例如：
</p>
<div class="pre_wrapper lang-console">
<pre class="programlisting prettyprint lang-console">GET /_search
{
    "query": {
        "common": {
            "body": {
                "query": "nelly the elephant as a cartoon",
                "cutoff_frequency": 0.001,
                "minimum_should_match": 2
            }
        }
    }
}</pre>
</div>
<div class="console_widget" data-snippet="snippets/145.console"></div>
<p>这大致相当于：</p>
<div class="pre_wrapper lang-console">
<pre class="programlisting prettyprint lang-console">GET /_search
{
    "query": {
        "bool": {
            "must": {
                "bool": {
                    "should": [
                    { "term": { "body": "nelly"}},
                    { "term": { "body": "elephant"}},
                    { "term": { "body": "cartoon"}}
                    ],
                    "minimum_should_match": 2
                }
            },
            "should": [
                { "term": { "body": "the"}},
                { "term": { "body": "as"}},
                { "term": { "body": "a"}}
                ]
        }
    }
}</pre>
</div>
<div class="console_widget" data-snippet="snippets/146.console"></div>
<p>
不同的 <a class="xref" href="query-dsl-minimum-should-match.html" title="minimum_should_match parameter"><code class="literal">minimum_should_match</code></a>参数值 可通过额外的 <code class="literal">low_freq</code> 和 <code class="literal">high_freq</code> 参数应用于低频和高频项。

以下是提供额外参数时的一个示例（注意结构上的变化）：
</p>
<div class="pre_wrapper lang-console">
<pre class="programlisting prettyprint lang-console">GET /_search
{
    "query": {
        "common": {
            "body": {
                "query": "nelly the elephant not as a cartoon",
                "cutoff_frequency": 0.001,
                "minimum_should_match": {
                    "low_freq" : 2,
                    "high_freq" : 3
                }
            }
        }
    }
}</pre>
</div>
<div class="console_widget" data-snippet="snippets/147.console"></div>
<p>这大致相当于：</p>
<div class="pre_wrapper lang-console">
<pre class="programlisting prettyprint lang-console">GET /_search
{
    "query": {
        "bool": {
            "must": {
                "bool": {
                    "should": [
                    { "term": { "body": "nelly"}},
                    { "term": { "body": "elephant"}},
                    { "term": { "body": "cartoon"}}
                    ],
                    "minimum_should_match": 2
                }
            },
            "should": {
                "bool": {
                    "should": [
                    { "term": { "body": "the"}},
                    { "term": { "body": "not"}},
                    { "term": { "body": "as"}},
                    { "term": { "body": "a"}}
                    ],
                    "minimum_should_match": 3
                }
            }
        }
    }
}</pre>
</div>
<div class="console_widget" data-snippet="snippets/148.console"></div>
<p>
在本例中，这意味着高频词项只有在至少有三个词项时才会对相关性产生影响。  

但是，对于高频词项，<a class="xref" href="query-dsl-minimum-should-match.html" title="minimum_should_match parameter"><code class="literal">minimum_should_match</code></a> 最有趣的用途是在只有高频词项的情况下：
</p>
<div class="pre_wrapper lang-console">
<pre class="programlisting prettyprint lang-console">GET /_search
{
    "query": {
        "common": {
            "body": {
                "query": "how not to be",
                "cutoff_frequency": 0.001,
                "minimum_should_match": {
                    "low_freq" : 2,
                    "high_freq" : 3
                }
            }
        }
    }
}</pre>
</div>
<div class="console_widget" data-snippet="snippets/149.console"></div>
<p>这大致相当于：</p>
<div class="pre_wrapper lang-console">
<pre class="programlisting prettyprint lang-console">GET /_search
{
    "query": {
        "bool": {
            "should": [
            { "term": { "body": "how"}},
            { "term": { "body": "not"}},
            { "term": { "body": "to"}},
            { "term": { "body": "be"}}
            ],
            "minimum_should_match": "3&lt;50%"
        }
    }
}</pre>
</div>
<div class="console_widget" data-snippet="snippets/150.console"></div>
<p>
因此，与使用 <code class="literal">AND</code>相比，高频（词项）生成的查询限制略少。
</p>
<p>
<code class="literal">common</code> 词项查询还支持 <code class="literal">boost</code> 和 <code class="literal">analyzer</code>作为参数。
</p>
</div>
<div class="navfooter">
<span class="prev">
<a href="query-dsl-multi-match-query.html">« 多字段匹配(multi_match)查询</a>
</span>
<span class="next">
<a href="query-dsl-query-string-query.html">查询字符串(query_string)查询 »</a>
</span>
</div>
</div>

                  <!-- end body -->
                        </div>
                        <div class="col-xs-12 col-sm-4 col-md-4" id="right_col">
                        
                        </div>
                    </div>
                </div>
            </section>
        </div>
    </section>
</div>
<script src="../static/cn.js"></script>
</body>
</html>